home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 November / macformat-043.iso / mac / Shareware Plus / Developers / OpenStack Rinaldi Collection / openstack-rinaldi-lib / FullFind 1.5 (US) / FullFind 1.5 (US).rsrc / HELP_5635 next >
Encoding:
Text File  |  1996-01-09  |  3.3 KB  |  72 lines
  1.  
  2.  
  3.                                               FullFind 1.5
  4.  
  5.                                           by Frédéric RINALDI
  6.  
  7. DESCRIPTION
  8.   FullFind XFCN allows to search for first of all matches of a string in a container.
  9.  
  10. SYNTAX
  11.           FullFind(<container>,<pattern>[,<exactly>[,<all>[,<case sens.>
  12.                         [,<start>[,<item(s)>]]]])
  13.  
  14. PARAMETERS
  15.    <container> is where the pattern will  be searched in.
  16.  
  17.    <pattern> is the search string, and cannot exceed 255 chars.
  18.  
  19.    <exactly> can be true or false, and defines if the search will match the pattern as full word (true), or just as chars (false). Default is true.
  20.  
  21.    <all> can be true or false, and defines if the search will return only the first match (false), or all matches (true). Default is false.
  22.  
  23.    <case sens.> can be true or false, and defines if the search must be case sensitive (true) or not (false). Default is false.
  24.  
  25.    <start> is an integer defining the char after which the search begins. Default is 0.
  26.  
  27.    <item(s)> is an item list of the item numbers in which the pattern will be sarched in each line. Default is the whole line.
  28.  
  29.    Using "!", "?" and "=" as parameter will return an online help (resp. copyright, syntax and output).
  30.  
  31. USING
  32.    The XFCN returns a one or many lines result, each one containing four items "X,Y,Z,T", where :
  33.      X is the position in the container of the first char of the pattern
  34.      Y is the line number
  35.      Z is the position in the line of the first char of the pattern
  36.      T is the item number
  37.  
  38.    If the pattern is not found, the XFCN returns an empty string.
  39.  
  40. ERRORS
  41.    If an error occurs, FullFind can return :
  42.      "Error : Missing parameter(s)"
  43.      "Error : Param 3 must be true|false"
  44.      "Error : Param 4 must be true|false"
  45.      "Error : Param 5 must be a positive integer"
  46.      "Error : Param 6 must be an integer > 0"
  47.      "Error : Couldn't build the result"
  48.      "Error : Separator char not allowed at the end of pattern"
  49.  
  50. HISTORY
  51. 1.5                                                                                         01/07/93
  52. • Fixed bug with return-delimited searches
  53.                                                                                          
  54. 1.4                                                                                         05/17/92
  55. • Added itemDelimiter handling for specific item searching
  56.                                                                                          
  57. 1.3                                                                                         02/23/92
  58. • Search no more limited to 32000 chars
  59. • Added exact search with multi-word pattern
  60.  
  61. 1.2                                                                                         08/16/91
  62. • Added "=" online help param
  63. • Using Script Mgr to find word boundaries
  64. --------------------------------------------------------------------
  65.    All externals included in this stack are FreeWare and may be used in non-commercial software provided the following notice is visibly present :
  66.  
  67.                    FullFind XFCN, © Frederic Rinaldi, 1989…1993.
  68.  
  69.    Free for non-commercial use. Use in commercial software subjected to prior acknowledgement and licensing from the author, reachable at the following network addresses:
  70.  
  71. AppleLink: RINALDI1   CalvaCom : FR10    Compuserve : 71170,2111
  72.                Internet : RINALDI1@APPLELINK@APPLE.COM